home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / utils / xaes_bg.lzh / XAES_BG.TXT < prev   
Text File  |  1994-05-26  |  19KB  |  451 lines
  1.  
  2.  
  3.      *******  *******      ******      **************    *********
  4.       *****    *****     **********     *****   *****  *****   *****
  5.       *****    *****    *****  *****    *****         *****     *****
  6.        *****  *****    *****    *****   *****   ***   ******
  7.          ********      **************   ***********     ***********
  8.        *****  *****    *****    *****   *****   ***            ******
  9.       *****    *****   *****    *****   *****         *****     *****
  10.       *****    *****   *****    *****   *****   *****  *****   *****
  11.      *******  ******* *******  ******* **************    ********* 
  12.  
  13.                        X A E S   B A C K G R O U N D
  14.  
  15.                           XAES Background  (LTMF-2)
  16.                           -------------------------
  17.  
  18.                      (Updated versions  of Let 'em Fly)
  19.  
  20.                                Version 0.99A
  21.                                  May  1994
  22.  
  23.            (c) 1991-94 Freaky Deaky Software and Bitgate Software
  24.  
  25.   Written in C and Assembly by Oliver Scheel, Ken Hollis and Darryl Piper
  26.  
  27.                               (it's  Shareware)
  28.  
  29.  
  30.                                  Introduction
  31.                                ================
  32.  
  33. Major news:  Let 'em Fly has been taken over by Bitgate Software.  The main
  34. reason being because Oliver Scheel has left the Atari scene, and allowed
  35. Darryl and I to update the program.  You will see more updates here and
  36. there, probably every two months.  For new additions that will be added,
  37. please see the end of this document.
  38.  
  39. Other news, Let 'em Fly is now known as XAES.  What does this mean?  It's
  40. to stop all of the confusion of the versions of Let 'em Fly that are
  41. already roaming around out there.  Since Let 'em Fly has changed to XAES,
  42. the next major release that is done will be XAES 1.00 (version number) so
  43. it will stop confusion.  The next version looks very promising.
  44.  
  45.  
  46.                            About XAES Background
  47.                          =========================
  48.  
  49. With XAES Background in your AUTO-Folder, many normal GEM dialogs learn to
  50. fly like Julian Reschke's FlyDials (e.g. in Gemini).  Furthermore, these
  51. dialogs can be handled by using the shortcuts XAES Background offers.  There
  52. are many more features!  The most important are:
  53.  
  54. - flying dials
  55.     As already described, many GEM dialogs learn to fly.  This means you 
  56.     can drag them around by using the mouse (ie. moving them by clicking a
  57.     non-selectable spot in the dialog or clicking outside of the dialog).
  58.     This requires that programs use the right AES calls to handle
  59.     dialogs.
  60.  
  61. - key dials
  62.     Many dialogs can be operated by using shortcuts.  XAES Background scans 
  63.     the dialog for possible keys.  For example, the button 'Cancel' may 
  64.     be activated by pressing [UNDO] and/or [ALT]+[C].  Also, if there are
  65.     any dialog boxes that are displayed, and they don't contain any
  66.     editable text items (ie. FTEXT type) you can activate a key dial by
  67.     simply pressing the corresponding key without [ALT].
  68.  
  69. - new edit functions within editable fields
  70.     This includes clipboard support, a history and a special character box 
  71.     to enter 'ugly' chars.  You can also reposition the cursor within the
  72.     dialog box by using the mouse, and clicking a space within the editable
  73.     item.
  74.  
  75. - new alert boxes with new icons
  76.     The alert boxes have also been reimplemented.  They look more 'right 
  77.     sized' and allow to load new icons.
  78.  
  79. - grow and shrink boxes can be switched off
  80.     To speed up building the screen, XAES Background allows you to switch
  81.     off the grow and shrink boxes.
  82.  
  83. - no pilot's licence needed
  84.     You got it!  For using XAES Background, you don't need to absolve
  85.     flying lessons.  Basic experiences in using the mouse should be
  86.     known, though...
  87.  
  88.  
  89. XAES Background works on Atari ST/STe/TT/Falcon computers under all 
  90. resolutions, including true color.  The new MultiTOS is supported, too,
  91. sort of...
  92.  
  93. XAES Background comes with no warranty.  This means that the authors will
  94. not be liable for any damage which may caused by using or not using Let
  95. 'em Fly II.
  96.  
  97. XAES Background is Shareware.  This means that this program may be freely
  98. used and distributed for non-commercial use.  All rights are reserved by
  99. the authors!
  100.  
  101. The XAES Background distribution package:
  102.  
  103.      - XAES_BG .PRG           the program itself
  104.  
  105.      - GEM1ICON.RSC           the original Atari icons
  106.      - GEM2ICON.RSC           the GEM/2 icons
  107.      - LTMFICON.RSC           the XAES Background icons
  108.  
  109.      - XAES_BG .TXT           this manual
  110.  
  111.  
  112.                                 Installation
  113.                               ================
  114.  
  115. It's very easy to install XAES Background.  Copy the program LETEMFLY.PRG
  116. into your AUTO-Folder and restart your computer.  To configure Let 'em Fly
  117. II you can use the accessory LET_CONF.ACC or the CPX LET_CONF.CPX.  The
  118. ACC also runs as a program by renaming it into LET_CONF.APP or .PRG. The
  119. switches are described later on.
  120.  
  121.  
  122.                                    Usage
  123.                                  =========
  124.  
  125. XAES Background requires that programs use the right AES calls to handle 
  126. dialogs.  Otherwise XAES Background can't act as wanted.  These calls are
  127. mainly form_do, form_button and form_keybd calls.  Any calls that handle
  128. their own dialogs will bypass XAES Background's AES calls completely.
  129.  
  130.  
  131. Flying Dials
  132. ------------
  133.  
  134. Within a GEM dialog there are selectable and non-selectable objects.  If
  135. you click a non selectable object the mouse arrow changes into a flat hand 
  136. and you can drag the dialog around by moving the mouse.  By holding the 
  137. [SHIFT] key or the right mouse button, the dialog gets transparent and 
  138. you can look 'through' it if it's hiding some important information
  139. behind it.
  140.  
  141. If you don't like where the dialog box is positioned, simply double-click
  142. on the root object (the dialog box itself, or a non-selectable object) and
  143. it will automatically re-center itself.
  144.  
  145.  
  146. Key Dials
  147. ---------
  148.  
  149. XAES Background scans the current dialog for possible shortcuts and marks 
  150. them by drawing a line under the corresponding letter or highlighting it.
  151. You can activate the button by holding the [ALT] key and pressing the
  152. letter (or number).  If there is no editable field you don't need to press
  153. the [ALT] key.  The functions keys [UNDO] and [HELP] are supported, too.
  154. XAES Background scans the following strings to define these function keys:
  155.  
  156. [UNDO]: 'abbruch', 'abbrechen', 'verlassen', 'ende', 'nein', 'quit', 
  157.         'cancel', 'abort', 'no', 'exit', 'forget', 'bypass', 'exclude'
  158.  
  159. [HELP]: 'help', 'hilfe', 'info', 'more', 'next'
  160.  
  161. (Remember, the original version of Let 'em Fly was in German, so expect
  162.  these to stay the same!)
  163.  
  164. The UNDO button and the default button can be normally activated via the 
  165. first letter (e.g. 'Cancel' via [ALT]+[C]).  Furthermore, it's possible to 
  166. 'move' the default button around by pressing [ALT]+[Tab] or [ALT]+[SHIFT]+
  167. [Tab] (backwards).  [SHIFT]+[Help] displays a copyright information
  168. including the current version number.
  169.  
  170.  
  171. Extended Editor
  172. ---------------
  173.  
  174. Within editable fields, there are more functions when using XAES Background. 
  175. GEM supports the following functions:
  176.  
  177. [Cursor Up]         one field back
  178. [Cursor Down]       one field forward
  179. [Cursor Left]       one character left
  180. [Cursor Right]      one character right
  181. [TAB]               one field forward
  182. [RETURN]            terminate (apply) the dialog
  183.  
  184. (How boring GEM makes object editing!)
  185.  
  186. But XAES Background gives you many many more functions ...
  187.  
  188. [RETURN]            if there is no default button, it jumps to the next 
  189.                     editable field
  190. [SHIFT]+[RETURN]    jumps to the next editable field, even if there is a 
  191.                     default button
  192. [SHIFT]+[TAB]       one field back
  193. [SHIFT]+[Csr Left]  jumps to the beginning of the field
  194. [SHIFT]+[Csr Right] jumps to the end of the field
  195. [CTRL]+[Csr Left]   jumps one word left
  196. [CTRL]+[Csr Right]  jumps one word right
  197. [Home]              jumps to the first editable field
  198. [S